

    \filetitle{vline}{Add vertical line with text caption at the specified position}{grfun/vline}

	\paragraph{Syntax}

\begin{verbatim}
[Ln,Cp] = grfun.vline(Pos,...)
[Ln,Cp] = grfun.vline(Ax,Pos,...)
\end{verbatim}

\paragraph{Input arguments}

\begin{itemize}
\item
  \texttt{Pos} {[} numeric {]} - Horizontal position or vector of
  positions at which the vertical line(s) will be drawn.
\item
  \texttt{Ax} {[} numeric {]} - Handle to an axes object (graph) or to a
  figure window in which the the line will be added; if not specified
  the line will be added to the current axes.
\end{itemize}

\paragraph{Output arguments}

\begin{itemize}
\item
  \texttt{Ln} {[} numeric {]} - Handle to the vline(s) plotted (line
  objects).
\item
  \texttt{Cp} {[} numeric {]} - Handle to the caption(s) created (text
  objects).
\end{itemize}

\paragraph{Options}

\begin{itemize}
\item
  \texttt{\textquotesingle{}caption=\textquotesingle{}} {[} char {]} -
  Annotate vline with a text string.
\item
  \texttt{\textquotesingle{}excludeFromLegend=\textquotesingle{}} {[}
  \emph{\texttt{true}} \textbar{} \texttt{false} {]} - Exclude vline
  from legend.
\item
  \texttt{\textquotesingle{}hPosition=\textquotesingle{}} {[}
  \texttt{\textquotesingle{}center\textquotesingle{}} \textbar{}
  \texttt{\textquotesingle{}left\textquotesingle{}} \textbar{}
  \emph{\texttt{\textquotesingle{}right\textquotesingle{}}} {]} -
  Horizontal position of the caption.
\item
  \texttt{\textquotesingle{}vPosition=\textquotesingle{}} {[}
  \texttt{\textquotesingle{}bottom\textquotesingle{}} \textbar{}
  \texttt{\textquotesingle{}middle\textquotesingle{}} \textbar{}
  \emph{\texttt{\textquotesingle{}top\textquotesingle{}}} \textbar{}
  numeric {]} - Vertical position of the caption.
\item
  \texttt{\textquotesingle{}timePosition=\textquotesingle{}} {[}
  \texttt{\textquotesingle{}after\textquotesingle{}} \textbar{}
  \texttt{\textquotesingle{}before\textquotesingle{}} \textbar{}
  \emph{\texttt{\textquotesingle{}middle\textquotesingle{}}} {]} -
  Placement of the vertical line on the time axis: in the middle of the
  specified period, immediately before it (between the specified period
  and the previous one), or immediately after it (between the specified
  period and the next one).
\end{itemize}

\paragraph{Description}

\paragraph{Example}


